@inquirer/input

@inquirer/input

Interactive free text input component for command line interfaces. Supports validation, filtering, transformation, etc.

Special Thanks

Warp, the intelligent terminal for developers

^{Available for MacOS and Linux
Visit warp.dev to learn more}

Installation

npm	yarn
npm install @inquirer/prompts	yarn add @inquirer/prompts
Or
npm install @inquirer/input	yarn add @inquirer/input

Usage

import { input } from '@inquirer/prompts';
// Or
// import input from '@inquirer/input';

const answer = await input({ message: 'Enter your name' });

Options

Property	Type	Required	Description
message	string	yes	The question to ask
default	string	no	Default value if no answer is provided (press backspace to clear the default; press tab to inline the value for edits)
required	boolean	no	Defaults to false. If set to true, undefined (empty) will not be accepted for this.
transformer	(string, { isFinal: boolean }) => string	no	Transform/Format the raw value entered by the user. Once the prompt is completed, isFinal will be true. This function is purely visual, modify the answer in your code if needed.
validate	string => boolean | string | Promise<boolean | string>	no	On submit, validate the filtered answered content. When returning a string, it'll be used as the error message displayed to the user. Note: returning a rejected promise, we'll assume a code error happened and crash.
theme	See Theming	no	Customize look of the prompt.

Theming

You can theme a prompt by passing a theme object option. The theme object only need to includes the keys you wish to modify, we'll fallback on the defaults for the rest.

type Theme = {
  prefix: string | { idle: string; done: string };
  spinner: {
    interval: number;
    frames: string[];
  };
  style: {
    answer: (text: string) => string;
    message: (text: string, status: 'idle' | 'done' | 'loading') => string;
    error: (text: string) => string;
    defaultAnswer: (text: string) => string;
  };
  validationFailureMode: 'keep' | 'clear';
};

validationFailureMode defines the behavior of the prompt when the value submitted is invalid. By default, we'll keep the value allowing the user to edit it. When the theme option is set to clear, we'll remove and reset to an empty string.

License

Copyright (c) 2023 Simon Boudrias (twitter: @vaxilart)
Licensed under the MIT license.